home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Plus 1995 #5 & #6
/
Amiga Plus CD - 1995 - No. 5 and 6.iso
/
pd
/
serien
/
purity
/
nr.44
/
superviewpcq
/
docs
/
svoperator_ref_eng.doc
< prev
next >
Wrap
Text File
|
1995-01-28
|
4KB
|
170 lines
$VER: SVOperator_Ref_ENG.doc V1.1 (30.9.94)
© 1994 by Andreas R. Kleinert. All rights reserved.
- Feel free to translate this Doc-File into other languages. -
Andreas R. Kleinert,
Grube Hohe Grethe 23,
D-57074 Siegen,
Germany.
Phone: +49-271-331859 (weekdays after 18.00h)
+49-271-332147 (weekdays after 18.00h)
EMail: Fido Andreas Kleinert 2:2457/345.10
Usenet/InterNet Andreas_Kleinert@superview.ftn.sub.org
If nothing else works, try one of these Fido-InterNet gateways:
Andreas_Kleinert@p10.f345.n2457.z2.fido.sub.org (Germany)
Andreas_Kleinert@p10.f345.n2457.z2.fidonet.org (US)
* DO _NEVER_ ACCESS ANY SVOPERATORS DIRECTLY.
* DO NEVER BYPASS superview.library !
THE FOLLOWING NOTES ARE ONLY FOR PROGRAMMERS OF SVOPERATORS :
Here is a listing of the function set, which any of the version 1
SVOperators does contain, in an Autodoc-like style of description :
SVP_AllocHandle ; since Version 1
SVP_FreeHandle
SVP_DoOperation
(you will never find any notes belonging to "BUGS", because any SVOperator
may have its own ...)
-----------------------------------------------------------------------------
Functions available since Version 1 :
-----------------------------------------------------------------------------
NAME
SVP_AllocHandle
SYNOPSIS
APTR SVP_AllocHandle(APTR future)
D0 -$1e A1
FUNCTION
Allocates a handle for handling a GfxBuffer via this SVOperator.
INPUT(S)
future - always NULL yet
RESULT
A pointer to a new allocated Handle or NULL, if allocation failed.
WARNING
Test, if the result was NULL, or not !
SINCE
... Version 1 SVOperators.
SEE ALSO
SVP_FreeHandle
-----------------------------------------------------------------------------
NAME
SVP_FreeHandle
SYNOPSIS
VOID SVP_FreeHandle(APTR handle)
D0 -$24 A1
FUNCTION
Aborts showing, frees all Resources and delocates a Handle, which has
been allocated with SVP_AllocHandle before.
For programmers of SVDrivers :
Note, that this function should call
SVP_CloseDisplay(SVHandle);
SVP_FreeResources(SVHandle);
internally always. Otherwise memory might be lost, because
superview.library might only make a call to SVO_FreeHandle(),
without closing the display/freeing the resources before.
INPUT(S)
handle - a valid handle
RESULT
-
SINCE
... Version 1 SVOperators.
SEE ALSO
SVP_AllocHandle, SVP_DoOperation
-----------------------------------------------------------------------------
NAME
SVP_DoOperation
SYNOPSIS
ULONG SVP_DoOperation(APTR handle, struct SV_GfxBuffer *source,
D0 -$2a A1 A2
struct SV_GfxBuffer **dest,
A3
APTR future);
D1
FUNCTION
handle = SVP_AllocHandle(N);
sverr = SVP_DoOperation( ... );
SVP_FreeHandle(handle);
This function allows to do a specific operation on a given
SV_GfxBuffer.
The Source buffer is not touched this way, but a new buffer will
be allocated instead.
The pointer of the new buffer is returned by writing it to a given
pointer variable.
INPUT(S)
handle - a valid handle
source - a SV_GfxBuffer to be used as "source"
dest - a pointer to a pointer for the "destination" SV_GfxBuffer
future - always NULL yet
RESULT
NULL or an adequate SVERR-Errorcode.
SINCE
... Version 1 SVOperators.
SEE ALSO
SVP_AllocHandle(), SVP_FreeHandle()
-----------------------------------------------------------------------------